Skip to content

docs(testing): add componentOnReady guidance and a Vue testing page - #4611

Merged
thetaPC merged 7 commits into
ionic-team:mainfrom
Zac-Smucker-Bryan:zsb-ionic-docs
Aug 7, 2026
Merged

docs(testing): add componentOnReady guidance and a Vue testing page#4611
thetaPC merged 7 commits into
ionic-team:mainfrom
Zac-Smucker-Bryan:zsb-ionic-docs

Conversation

@Zac-Smucker-Bryan

@Zac-Smucker-Bryan Zac-Smucker-Bryan commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Resolves #3808

Description

  • Adds guidance about import componentOnReady for standalone projects from @ionic/core as a helper to improve testing when working with Ionic standalone, for Angular, React, and Vue
  • Adds a testing page for Vue (mostly a starter template with the standalone guidance above)
  • Adds specific testing example in the case of Angular w/the import implemented and then the helper called in the test.

Change Type

  • Fix
  • Feature
  • Refactor
  • Breaking Change
  • Documentation
  • Other (CI, chores, etc.)

Rationale / Problems Fixed

Standalone users can't always consistently test what they need without better guidance.

Notes / Comments

There is a companion issue (ionic-team/ionic-framework#31312) and PR (ionic-team/ionic-framework#31313) in ionic-framework that might need to be coordinated for language tweaks.

For Angular, React, and Vue. Includes new testing page for Vue as a starter.
@Zac-Smucker-Bryan
Zac-Smucker-Bryan requested a review from a team as a code owner July 31, 2026 15:01
@vercel

vercel Bot commented Jul 31, 2026

Copy link
Copy Markdown

@Zac-Smucker-Bryan is attempting to deploy a commit to the Ionic Team on Vercel.

A member of the Team first needs to authorize it.

@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ionic-docs Ready Ready Preview Aug 7, 2026 10:06pm

Request Review

Comment thread docs/angular/testing.md Outdated
Comment thread docs/angular/testing.md Outdated
Comment thread docs/angular/testing.md Outdated
Comment thread docs/angular/testing.md Outdated
Comment thread docs/react/testing/unit-testing/best-practices.md Outdated
Comment thread docs/vue/testing.md Outdated
Comment thread docs/vue/testing.md Outdated
Comment thread docs/vue/testing.md Outdated
Comment thread docs/vue/testing.md Outdated
Comment thread docs/vue/testing.md Outdated
Zac-Smucker-Bryan and others added 2 commits August 4, 2026 19:33
Clarity on use of componentOnReady, conciseness of test example

Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
Slight rephrasing of paragraph explaining componentOnReady helper
Add more concise test to Angular using componentOnReady helper
Move Angular to last part of Unit Testing
Add example test for React, matching Angular
Small formatting edits to Vue, add Vue testing page to sidebar
@Zac-Smucker-Bryan

Copy link
Copy Markdown
Contributor Author

Thanks for the feedback @thetaPC. I think I addressed all your comments. Let me know what else might need to be changed.

Comment thread docs/react/testing/unit-testing/best-practices.md
Comment thread docs/vue/testing.md
Zac-Smucker-Bryan and others added 2 commits August 5, 2026 14:19
Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
From code/docs review feedback
@Zac-Smucker-Bryan

Copy link
Copy Markdown
Contributor Author

PR revised based on feedback

1 similar comment
@Zac-Smucker-Bryan

Copy link
Copy Markdown
Contributor Author

PR revised based on feedback

@thetaPC thetaPC left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Almost there!

Comment thread docs/react/testing/unit-testing/best-practices.md Outdated
Comment thread docs/vue/testing.md Outdated
Zac-Smucker-Bryan and others added 2 commits August 7, 2026 16:40
Co-authored-by: Maria Hutt <thetaPC@users.noreply.github.com>
Adding suggested changed to Vue test
@thetaPC thetaPC changed the title docs(tests): Add specific guidance to testing standalone docs(testing): add componentOnReady guidance and a Vue testing page Aug 7, 2026

@thetaPC thetaPC left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, I've also updated the PR title to match

@thetaPC
thetaPC merged commit 52829ef into ionic-team:main Aug 7, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

content: Ionic Angular Testing (Standalone etc)

2 participants